package com.sky.service;

import com.sky.vo.OrderReportVO;
import com.sky.vo.SalesTop10ReportVO;
import com.sky.vo.TurnoverReportVO;
import com.sky.vo.UserReportVO;

import java.time.LocalDate;

/**
 * 在线报表业务接口
 * @Author Vsunks.v
 * @Date 2023/5/13 10:02
 * @Blog blog.sunxiaowei.net
 * @Description:
 */
public interface ReportService {

    /**
     * 商品销量排行统计在线报表
     *
     * @param begin 报表统计开始时间（以送达时间为准）
     * @param end   报表统计结束时间（以送达时间为准）
     * @return 报表数据
     */
    SalesTop10ReportVO salesTop10(LocalDate begin, LocalDate end);

    /**
     * 营业额统计在线报表（日销售额）
     *
     * @param begin 报表统计开始时间（以送达时间为准）
     * @param end   报表统计结束时间（以送达时间为准）
     * @return 报表数据
     */
    TurnoverReportVO turnoverStatistics(LocalDate begin, LocalDate end);

    /**
     * 订单量统计在线报表
     *
     * 查询得到：日总订单量、日有效订单量
     * 计算得到：时间段内总订单量、时间段内总有效订单量、时间段内总订单完成率
     *
     * @param begin 报表统计开始时间（以下单时间为准）
     * @param end   报表统计结束时间（以下单时间为准）
     * @return 报表数据
     */
    OrderReportVO ordersStatistics(LocalDate begin, LocalDate end);

    /**
     * 用户量统计在线报表（日总用户量、日新增用户量）
     *
     * @param begin 报表统计开始时间（以注册时间为准）
     * @param end   报表统计结束时间（以注册时间为准）
     * @return 报表数据
     */
    UserReportVO userStatistics(LocalDate begin, LocalDate end);
}
